/**
 * <h3>advertisementController</h3>
 * <p> 广告信息管理控制器类 </p>
 *
 * <h3>功能描述</h3>
 * <p> 提供广告信息的增删改查等基础操作接口，统一返回AjaxResult格式结果 </p>
 * <p> 所有接口均基于RESTful风格设计，配合SpringMVC与Swagger注解实现标准化API输出 </p>
 *
 * <h3>元数据</h3>
 * <ul>
 *    <li> 作者：郭强 </li>
 *    <li> 创建日期：2025年05月20日 21:09:09 </li>
 * </ul>
 *
 * <h3>其他信息</h3>
 * <ul>
 *    <li> 参考链接：<a href="https://fantastic-admin.hurui.me/guide/permission.html">权限控制文档</a></li>
 *    <li> 示例代码：{@code new advertisementController()} </li>
 * </ul>
 *
 * @apiNote 接口需结合前端权限配置使用，确保安全性；当前未启用权限注解
 * @implSpec 继承自 {@link BaseController}，复用分页、返回封装等通用逻辑
 * @since v1.0.0.0
 */

package com.dnndo.web.controller.system;


import com.dnndo.common.annotation.Log;
import com.dnndo.common.core.controller.BaseController;
import com.dnndo.common.core.domain.AjaxResult;
import com.dnndo.common.core.domain.PageResult;
import com.dnndo.common.core.domain.R;
import com.dnndo.common.enums.BusinessType;
import com.dnndo.common.utils.bean.BeanDtoVoUtil;
import com.dnndo.system.domain.Advertisement;
import com.dnndo.system.domain.dto.AdvertisementDTO;
import com.dnndo.system.domain.vo.AdvertisementVO;
import com.dnndo.system.service.IAdvertisementService;
import com.github.pagehelper.PageInfo;
import io.swagger.annotations.ApiParam;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.security.access.prepost.PreAuthorize;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;


import java.util.List;

/**
 * 广告信息controller类
 *
 * @author 郭强
 *
 */
@RestController
@RequestMapping("/system/advertisement")
public class AdvertisementController extends BaseController {


    private final IAdvertisementService advertisementService;

    @Autowired
    public AdvertisementController(IAdvertisementService advertisementService) {
        this.advertisementService = advertisementService;
    }

    /**
     * 查询广告列表（分页）
     *
     * @param dto 广告查询条件封装对象，包含广告名称、类型、省份等过滤条件
     * @return PageResult<Advertisement> 分页后的广告信息列表及总记录数
     * @see com.dnndo.system.domain.dto.AdvertisementDTO
     */
    @PreAuthorize("@ss.hasPermi('advertisement:list1')")
    @GetMapping("/list")
    public PageResult<AdvertisementVO> list(AdvertisementDTO dto) {
        startPage();
        List<Advertisement> list = advertisementService.selectAdvertisementList(dto);
        return PageResult.pageOk(BeanDtoVoUtil.listVo(list, AdvertisementVO.class), new PageInfo<>(list).getTotal());
    }

    /**
     * 根据广告ID获取详细信息
     *
     * @param advertisementId 广告唯一标识符
     * @return R<Advertisement> 包含广告详细信息的响应结果
     * @see com.dnndo.system.domain.dto.AdvertisementDTO
     */
//    @PreAuthorize("@ss.hasPermi('system:user:getInfo')")
    @GetMapping("/getInfo")
    public AjaxResult getInfo(@ApiParam(value = "广告ID", required = true) Long advertisementId) {
        AdvertisementDTO advertisement = advertisementService.selectAdvertisementListById(advertisementId);
        return AjaxResult.success(R.ok(BeanDtoVoUtil.convert(advertisement, AdvertisementVO.class)));
    }

    /**
     * 新增广告信息
     *
     * @param dto 前端传入的广告数据传输对象，包含新增字段
     * @return AjaxResult 操作结果返回对象，包含成功或失败状态
     * @see com.dnndo.system.domain.dto.AdvertisementDTO
     */
//    @PreAuthorize("@ss.hasPermi('system:user:add')")
    @Log(title = "广告管理", businessType = BusinessType.INSERT)
    @PostMapping("/add")
    public AjaxResult add(@Validated @RequestBody AdvertisementDTO dto) {
        return toAjax(advertisementService.insertAdvertisement(dto));
    }

    /**
     * 修改已有广告信息
     *
     * @param dto 前端传入的广告数据传输对象，包含更新字段
     * @return AjaxResult 操作结果返回对象，包含成功或失败状态
     * @see com.dnndo.system.domain.dto.AdvertisementDTO
     */
//    @PreAuthorize("@ss.hasPermi('system:user:edit')")
    @Log(title = "广告管理", businessType = BusinessType.UPDATE)
    @PostMapping("/edit")
    public AjaxResult edit(@Validated @RequestBody AdvertisementDTO dto)
    {
        AdvertisementDTO advertisementDTO = BeanDtoVoUtil.convert(dto, AdvertisementDTO.class);
        return toAjax(advertisementService.updateAdvertisementById(advertisementDTO));
    }

    /**
     * 删除指定ID的广告信息
     *
     * @param advertisementId 要删除的广告唯一标识符
     * @return AjaxResult 操作结果返回对象，包含成功或失败状态
     * @see com.dnndo.system.domain.dto.AdvertisementDTO
     */
//    @PreAuthorize("@ss.hasPermi('system:user:del')")
    @Log(title = "广告管理", businessType = BusinessType.DELETE)
    @GetMapping("/del")
    public AjaxResult del(@ApiParam(value = "广告ID",required = true) Integer advertisementId)
    {
        return toAjax(advertisementService.deleteAdvertisementById(advertisementId));
    }

}
